Revel Digital MCP Server

Manage your digital signage network with AI. The Revel Digital MCP Server exposes the Revel Digital CMS as a remote MCP server, letting Claude, ChatGPT, Cursor, and other MCP-compatible clients control devices, media, playlists, schedules, templates, and analytics through natural language — no API keys, no local install, just sign in with your Revel Digital account.

Overview

Revel Digital is an enterprise-grade, cloud-based digital signage platform used to manage content across Android, Windows, Linux, BrightSign, and Raspberry Pi displays. The Revel Digital MCP Server turns that platform into a headless, AI-addressable CMS: any MCP client can discover and invoke the full suite of platform operations as tools.

The server is hosted, remote, and OAuth-authenticated. There's nothing to install — point your MCP client at https://mcp.reveldigital.io/mcp, sign in through a browser-based OAuth flow backed by id.reveldigital.com, and every action the tool takes runs under your user's permissions.

Key Features

• Full platform coverage — Devices, device groups, media, media groups, playlists, schedules, templates, data tables, and users, all accessible as tools.
• Rich analytics — Query play logs, impression data, audience metrics (AdHawk), heatmaps, event flow, and device play stats directly from your AI assistant.
• GraphQL query builder — build_query, execute_query, introspect_schema, and quick_query tools let agents construct optimized GraphQL requests against the platform's schema without hand-writing queries.
• Remote commands — Send commands to individual devices or bulk-command fleets (reboot, reload, refresh, etc.).
• Data Tables — Create, read, update, and version-controlled rollbacks on custom Cosmos DB-backed tables with real-time SignalR propagation to players.
• Audit & ping logs — Pull account audit events and device connectivity logs for investigation and reporting.
• Deprecation-aware — Legacy REST-style tools are clearly marked so agents prefer the GraphQL path for new work.

How It Works

• Transport: Streamable HTTP at /mcp
• Authentication: OAuth 2.1 with Dynamic Client Registration (RFC 7591) and PKCE, delegating to Revel Digital's OpenID Connect provider at id.reveldigital.com
• Infrastructure: Cloudflare Workers + Durable Objects (one MCP session per authenticated user), built on @cloudflare/workers-oauth-provider and the Cloudflare Agents SDK (McpAgent)
• Tool surface: ~80 tools covering CRUD + analytics across the platform's resource graph

Every tool call is executed server-side against the Revel Digital REST and GraphQL APIs using the signed-in user's access token — your credentials never touch the AI model or the MCP client process.

Example Prompts

Once connected, you can drive your entire signage operation conversationally:

• "Show me all devices that haven't checked in since yesterday and group them by location."
• "Create a playlist called 'Holiday Promotions' from every media item tagged holiday, then schedule it on all lobby devices weekdays 9 AM to 6 PM through January 2."
• "Pull last month's impression data for the Fargo group and summarize age/gender distribution by hour of day."
• "Find any device running firmware below 2.4 and send a reload command to each."
• "Export rows from the menu_prices data table as CSV."

Getting Started

Claude (desktop or web) — Custom Connector

1. Open Settings → Connectors → Add custom connector
2. Name: Revel Digital
3. URL: https://mcp.reveldigital.io/mcp
4. Complete the OAuth sign-in in your browser when prompted

Cursor, Windsurf, VS Code (remote MCP)

Add the server URL in your client's MCP server settings — any client that supports remote MCP with OAuth will handle the flow natively.

MCP Inspector / other clients via mcp-remote

{
  "mcpServers": {
    "revel-digital": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.reveldigital.io/mcp"]
    }
  }
}

Restart the client; a browser window opens for Revel Digital sign-in, then tools become available.

Security & Permissions

Every tool call runs with your signed-in user's permissions. If you want agents to have read-only access, assign the connecting user to a role without create/update/delete permissions. Revel Digital is ISO 27001 certified; the MCP gateway adds no additional data storage — tokens are held in Cloudflare KV, tool calls pass through transparently.

Documentation & Resources

• Full docs: https://reveldigital.github.io/reveldigital-mcp-cloudflare/
• Revel Digital platform: https://www.reveldigital.com/

FAQ

Do I need to install anything? No. This is a hosted remote MCP server. Any MCP client that supports remote servers with OAuth can connect directly.

Do I need an API key? No. Authentication is handled through browser-based OAuth against your Revel Digital account. For legacy clients that don't support remote MCP, a separate stdio-based NPM package (@reveldigital/reveldigital-mcp-server) is also available and uses an API key.

Which MCP clients are supported? Claude (desktop and web), Cursor, Windsurf, Cloudflare AI Playground, VS Code with MCP support, and MCP Inspector. Any client implementing the Streamable HTTP transport with OAuth 2.1 will work.

What do the tools have access to? Everything the signed-in user can access in Revel Digital — devices, media, playlists, schedules, templates, data tables, analytics datasets, and user/organization administration. Permissions are enforced at the API layer.

Can I restrict the AI to read-only operations? Yes. Assign the authenticating user to a Revel Digital role without write permissions, and destructive tools will be rejected at the API layer.